home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / black100.zip / readme < prev    next >
Text File  |  1996-06-30  |  18KB  |  481 lines
  1. ======================================================================
  2. This file is part of the Blackout screen saver.       v1.00 1996-06-29
  3. Copyright (C) 1995, 1996 by Staffan Ulfberg.   
  4. ======================================================================
  5.  
  6.  
  7. --- IMPORTANT NOTICE! --- READ THIS FRIST! ---
  8.  
  9. This program controls the graphics hardware of your computer.  Some
  10. (but very few) graphics adapters are not supported, and serious bugs
  11. may exist in this program.  One implication of this is that there is a
  12. theoretical possibility that the program CAUSES DAMAGE to your system
  13. if used.  If you don't want to take this risk, DO NOT RUN THE PROGRAM!
  14. This program comes with absolutely NO WARRANTY.
  15.  
  16. Be sure to read the "Bugs / Future" and the "Copyright details"
  17. sections of this document before installing, using, or distributing
  18. this program.
  19.  
  20. ----------------------------------------------
  21.  
  22.  
  23.  
  24. CONTENTS
  25. ========
  26.  
  27. 1. What it is and what it is good for
  28. 2. Installation / Files in archive
  29. 3. Command line options
  30. 4. How it works
  31. 5. Bugs / Future
  32. 6. Credits
  33. 7. Copyright details
  34. 8. Author
  35. 9. Revision history
  36.  
  37.  
  38.  
  39. 1. WHAT IT IS AND WHAT IT IS GOOD FOR
  40. =====================================
  41.  
  42. "Blackout" is a completely FREE screen saver for OS/2 versions 2.0 and
  43. above.  It is intended for use with monitors that have DPMS, or
  44. "green," support.  I wrote the program primarily because I needed it
  45. myself, and was unable to locate a free one.  At the same time I
  46. thought this was a great time to learn about OS/2 programming.
  47.  
  48. The program blanks presentation manager and OS/2 full screen sessions;
  49. DOS full screen sessions are not blanked.  Of course, this holds for
  50. WIN-OS/2 full screen sessions as well.  I don't want my monitor to
  51. switch back on only because I happen to shake the table; therefore,
  52. the program is not sensitive to mouse moves by default.  A command
  53. line switch can change this behaviour.
  54.  
  55. You can forget about fancy graphics.  This program has three levels of
  56. screen saving: 1) after a user-programmable time, it dulls the screen.
  57. This will save the monitor, but you will still be able to see that
  58. it's turned on. 2) after some more time (possibly zero) the monitor
  59. will be switched to suspend mode, and 3) the monitor is switched off
  60. after some additional time.  Actually, it is also possible to replace
  61. 2) and 3) above with a turned on, black screen instead: look at the
  62. command line options section.
  63.  
  64. If you can't see a difference between suspend and off modes, it's
  65. probably because your monitor doesn't support suspend mode; some
  66. monitors just don't.
  67.  
  68. If the screen dulling doesn't seem to work properly---start the
  69. program using the switch "-s 0" to disable it (see Section 3); this is
  70. the most common graphics adapter incompatibility problem.  The dull
  71. (or grey) mode may work in some graphics modes but not in others.  In
  72. some cases, these problems are recognized by Blackout and which then
  73. adds the switch "-s 0" automatically.
  74.  
  75. There is now a homepage for Blackout on the world wide web; the URL is
  76. "http://www.nada.kth.se/~staffanu/blackout/blackout.html".
  77.  
  78. Staffan Ulfberg
  79. e-mail: staffanu@nada.kth.se
  80.  
  81.  
  82.  
  83. 2. INSTALLATION / FILES IN ARCHIVE
  84. ==================================
  85.  
  86. First of all, you need to have the emx runtime environment installed.
  87. If you don't already have that, get the file "emxrt.zip" which is
  88. available at all the major OS/2 ftp sites.  Follow the installation
  89. instructions that come with emxrt to install it.  Blackout won't run
  90. without it.
  91.  
  92. Create a directory for the screen saver (e.g., "c:\blackout").  Unzip
  93. the archive in this directory.  You will find the following files:
  94.  
  95.     README        This file
  96.     COPYING        The GNU General Public Licence
  97.     blackout.exe    The program to run to start Blackout.
  98.     black.exe    Program to switch off VSYNC and HSYNC.  This
  99.             program doesn't run alone without blackout
  100.             running.
  101.     blackdll.dll    DLL used by Blackout.
  102.     source.zip    The source code for the program files above.
  103.  
  104. (Maybe you did this already:) The program to run is "blackout.exe."
  105. It can be started from an icon on the desktop, possibly put in the
  106. desktop startup folder if you want to start the program automatically
  107. every time you start up your system.
  108.  
  109. The program won't say anything when started.  If you want to check if
  110. the program is running you could 1) wait for the screen to be blanked,
  111. 2) use the -l option (see next section), or 3) try to start the
  112. program again.  It will complain if already started.
  113.  
  114. One more thing: I strongly recommend not to start the "black.exe"
  115. program when Blackout is running already.  (How many will try this
  116. just because I told you not to???)
  117.  
  118.  
  119.  
  120. 3. COMMAND LINE OPTIONS
  121. =======================
  122.  
  123. On invocation, the following command line switches are available:
  124.  
  125. -t xx        Sets timeout before screen is greyed (made dull) in
  126.         minutes.  The default setting is 15 minutes.
  127.  
  128. -s yy        Sets time after the screen becomes dull until it
  129.         becomes switched to suspend mode using the DPMS
  130.         function.  Default for this parameter is 45 minutes.
  131.  
  132. -b zz        Sets the time from that the screen is switched to
  133.         suspend mode until it is turned off.  Default is 120
  134.         minutes.  Think about that it is not good for your
  135.         monitor to be turned off and back on too often!
  136.  
  137. -p ww        Some monitors and/or graphics adapters can't go
  138.         directly from suspend to off mode.  With this option,
  139.         the monitor is turned back on after suspend mode, and
  140.         is switched off after ww seconds.  Default is 0.
  141.  
  142. -l        Add Blackout to the system window list, so it can be
  143.         switched to by pressing CTRL-ESC.  The window
  144.         displayed contains no information.  The only reason
  145.         that this switch is included is that some people feel
  146.         safer knowing how to end the program from the window
  147.         list.
  148.  
  149. -m         Make the program sensible to mouse moves.  By default
  150.         only keyboard activity and mouse clicks are sensed
  151.         for. 
  152.  
  153. -o        Like the -m switch, this also adds mouse move sensing,
  154.         but only when the screen is on or dulled, and not when
  155.         in suspend or off mode.
  156.  
  157. -n        Don't use DPMS saving; instead, just turn the screen
  158.         black.  This switch is for people without DPMS
  159.         monitors who still want a minimalistic screen saver.
  160.  
  161. -g        Send an activity timeout to the Blackout process.
  162.         This option can be used to blank the screen at
  163.         startup, or at any other time.  See discussion below.
  164.  
  165. -f        Tells Blackout not to blank full screen OS/2
  166.         sessions.  Some full screen programs are reported not
  167.         to work well with blackout; one of these is
  168.         Microsoft's Programmer's Workbench for OS/2.
  169.  
  170. -r        Removes the program from memory if already loaded.
  171.  
  172.  
  173. The diagram below illustrates the effect of the -t, -s, and -b
  174. parameters.  "xx", "yy", and "zz" refers to the numeric arguments of
  175. the respective switches.
  176.  
  177.  
  178.  Screen  Screen         Screen          DPMS         DPMS     Screen
  179.  is on   still on   greyed/dulled   suspend mode   off mode   back on
  180. -------+----------+---------------+--------------+----------+-------->
  181.  User    User                                                 User
  182.  active  inactive                                             active
  183.  
  184.        <--- xx ---><----- yy -----><---- zz ----->
  185.  
  186.  
  187. If you don't want the grey mode of saving, use the option "-s 0".
  188. This is useful if your graphics adapter is not supported by blackout's
  189. greying function.  However, in most such cases this option is
  190. automatically added by Blackout.
  191.  
  192. The "-g" option can be used to blank the screen manually.  What will
  193. actually happen is that a WM_TIMER message will be sent to the running
  194. Blackout program---to make it think that the user has been inactive
  195. for a long time.  This switch can be repeated several times on the
  196. same command line: each occurence causes one WM_TIMER message to be
  197. sent.  Normally, the first message will cause the screen to become
  198. dull; the second will invoke suspend mode and the third off mode.  It
  199. is possible to give this command line option when Blackout is first
  200. started.  If Blackout is already running when invoked again with the
  201. -g option, all